home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / lib / c / etc / valloc.man < prev   
Text File  |  1992-04-21  |  1KB  |  52 lines
  1. '\" Copyright 1992 Regents of the University of California
  2. '\" Permission to use, copy, modify, and distribute this
  3. '\" documentation for any purpose and without fee is hereby
  4. '\" granted, provided that this notice appears in all copies.
  5. '\" The University of California makes no representations about
  6. '\" the suitability of this material for any purpose.  It is
  7. '\" provided "as is" without express or implied warranty.
  8. '\" 
  9. '\" $Header: /sprite/src/lib/c/etc/RCS/valloc.man,v 1.1 92/04/21 14:13:40 kupfer Exp $ SPRITE (Berkeley)
  10. '/" 
  11. .so \*(]ltmac.sprite
  12. .HS valloc lib
  13. .BS
  14. '\" Note:  do not modify the .SH NAME line immediately below!
  15. .SH NAME
  16. valloc \- page-aligned memory allocator
  17. .SH SYNOPSIS
  18. .nf
  19. \fB#include <unistd.h>\fR
  20. .sp
  21. void *
  22. \fBvalloc\fR(\fIsize\fP)
  23. .SH ARGUMENTS
  24. .AS size_t size
  25. .AP size_t size in
  26. Number of bytes to allocate.
  27. .BE
  28.  
  29. .SH DESCRIPTION
  30. .PP
  31. .B valloc
  32. is like 
  33. .BR malloc ,
  34. except that the pointer it returns is guaranteed to be page-aligned.
  35.  
  36. .SH BUGS
  37. .PP
  38. Using
  39. .B free
  40. to deallocate
  41. .BR valloc 'd
  42. memory can corrupt
  43. .BR malloc .
  44. Unfortunately, there is no
  45. .B vfree
  46. routine, so it is currently impossible to free
  47. .BR valloc 'd 
  48. memory.
  49.  
  50. .SH KEYWORDS
  51. memory, alloc
  52.